home *** CD-ROM | disk | FTP | other *** search
/ CD Classic / CD CLASSIC #1.iso / vgapaint / vgapaint.doc < prev    next >
Text File  |  1979-12-31  |  30KB  |  704 lines
  1. VGA PAINT
  2.  
  3. Description
  4.           VGA PAINT is a graphics/drawing program that produces screen
  5.           images in up to 248 colors at once.  Fourteen brush shapes
  6.           and four automatic shapes are provided.  Image handling
  7.           capabilities include: sizing, flipping, moving, copying and
  8.           saving images to disk.  Although the resolution of the
  9.           screen is only moderate (320 X 200), the careful use of
  10.           color mixing can produce images with near-photographic
  11.           realism.  
  12.  
  13.      VGA PAINT is written in Micosoft QuickBASIC 4.0. The
  14.           pictures and images produced by VGA PAINT are saved on disk
  15.           in the form of BASIC "BSAVE" files.  When loaded into an
  16.           integer array  with the dimension of 32004, these files may
  17.           be loaded by BASIC application programs and put on the
  18.           screen with the PUT (0,0) command in screen mode 13.
  19.  
  20. Requirements
  21.      IBM PC/XT/AT or compatible. (? Sys 2 /OS 2)
  22.      450K RAM
  23.      VGA card & appropriate analog or multi-sync monitor
  24.           capable of displaying screen modes 12 and 13.
  25.      Mouse (3 buttons recommended)
  26.      MSDOS 3.2
  27.  
  28.                Note: VGA PAINT was written for and on a KAYPRO PC
  29.                (8MHz), with 640K RAM, a Vega VGA card, a multi-sync
  30.                monitor in analog mode, and a PC Mouse.  It has also
  31.                been tested with several other (cheap) mice, and seems
  32.                to work o.k. with all of them.  VGA PAINT generates its
  33.                own cursor, and does not require a VGA mouse driver,
  34.                providing that the program can access the existing
  35.                driver with standard mouse calls to read the motion
  36.                counters and the status of the buttons.
  37.  
  38. Display:
  39.      320 X 200  with 248 displayable colors from a palette of
  40.      256K colors (screen mode 13).  Eight colors of the
  41.      usual 256 displayable colors are reserved for program
  42.      use.
  43.      
  44. Files provided:
  45.                VGAPAINT.EXE  (the main program)
  46.                MENU.VGA      (graphic menu screen file)
  47.                VGAPAINT.PAL  (a spare palette file)
  48.                LOGO.VGA      (the logo screen file)
  49.                VGA.DOC       (this file)
  50.  
  51. For the program to run, VGAPAINT.EXE & MENU.VGA  must be in the
  52. current directory.  If the file LOGO.VGA is present, the logo
  53. screen will appear when the program is run.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                    - 1 -
  66.  
  67.  
  68. PROGRAM OPERATION
  69.  
  70. Note:
  71.           B1=the right button on the mouse or CRTL
  72.           B2= the middle button or  Left SHIFT
  73.           B3=the left button or ALT
  74.  
  75.           For the indicated keyboard keys to function as mouse
  76.           buttons, the keyboard status byte for these keys must be at
  77.           0000:0417.  This is the standard address for IBM PC's and
  78.           truly compatible clones. The four cursor direction keys will
  79.           move the cursor one pixel at a time.
  80.  
  81. The program is invoked by typing VGAPAINT <enter>.  If the logo
  82. file is present, the VGA PAINT logo screen will be displayed.  To
  83. proceed, press any mouse button, or the spacebar.  The screen
  84. will clear, and the cursor will appear. At this point, the color
  85. is set to EGA red, and the brush shape is a small box.  
  86.  
  87.           Press B3 to display the menu.
  88.  
  89. MENU
  90.  
  91.           To return to the drawing, press B3.
  92.  
  93. PALETTE: The left half of the menu shows the palette of the 248
  94. displayable colors as they are originally set by the VGA card.
  95. These are not in numerical order. The color with the white box
  96. around it is the current Selected Color for drawing.  The color
  97. with the yellow box around it is the "color at cursor" -- the
  98. color in the drawing that was at the center of the cursor just
  99. before the menu was displayed.
  100.  
  101.           To select a color, move the cursor over the desired color,
  102.           and press B1.  The white box moves to the Selected Color.
  103.  
  104.           Pressing B2 while the cursor is over a palette color will
  105.           change that color to the Selected Color.  This is useful for
  106.           subsequent mixing of a color that differs only slightly from
  107.           the Selected Color.  NOTE: once changed, the only ways to
  108.           regain the original color are to mix it, or to load a
  109.           palette file with that color in it (e.g.,VGAPAINT.PAL)
  110.  
  111. FUNCTION BOXES:  The function boxes on the right half of the menu
  112. include the brush shapes (14), automatic shapes (circle, ellipse,
  113. box, line), and screen, image, and file manipulation functions.
  114. The "Mix" box on the left side of the screen is also a function
  115. box.  
  116.  
  117. When the cursor enters a function box, the box is outlined in
  118. bright green; the function may be selected by pushing B1.  
  119.  
  120.           MIX: Each of the 248 displayed colors may be mixed to any of
  121.           256K displayable colors. When B1 is pressed, the drawing
  122.           appears on the screen, with the mixing box in the upper left
  123.           corner.  The bottom of the mixing box shows a sample of the
  124.           current Selected Color for mixing. The small blue, red and
  125.           green boxes are used for mixing.  The color  bars above the
  126.           small boxes show the relative mixture of blue, green, and
  127.           red for the Selected Color. (None will appear is the
  128.           Selected Color is initially black).
  129.  
  130.  
  131.                                    - 2 -
  132.                
  133.           
  134.           You may select a different color to mix from the drawing by
  135.           moving the cursor to a point of that color and pressing B1. 
  136.           The mixing box will show the new color. This will not change
  137.           the Selected  Color when you resume drawing.
  138.  
  139.      To increase the amount of blue, green, or red in the color
  140.           to be mixed, place the cursor over the appropriate small box
  141.           and hold down B1.  The color bar will grow in length,  and
  142.           the sample of the color at the bottom of the mixing box will
  143.           show the new color. If the color being mixed is in the 
  144.           drawing, it will also change as you mix.
  145.  
  146.      To decrease the amount of blue, red, or green, put the
  147.           cursor over the appropriate small box and hold down B2.
  148.  
  149.           To save the color you have mixed and put it in the palette, 
  150.           move the cursor over the sample of the color at the     
  151.           bottom of the mixing box, and click B1.  You are now    
  152.           returned to the drawing.
  153.  
  154.      To cancel the mix and return the color to its original hue,
  155.           click B3.
  156.  
  157. BRUSH SHAPES & AUTOMATIC SHAPES: The 14 brush shapes and four
  158. automatic shapes comprise the basic drawing tools. When selected,
  159. the box containing that tool is set to red.  Selecting a tool
  160. does not immediately return to the drawing, so you can change
  161. your mind, select another color, or select another function. 
  162.  
  163.           B1 selects the tool.
  164.      B3 returns to the drawing.
  165.  
  166.      BRUSH SHAPES: when you return to the drawing:
  167.  
  168.                Hold B1 to use the brush. 
  169.  
  170.           Hold B2 to use selective erase. (See "ERASING" below).
  171.  
  172.           Click B3 to return to the menu.
  173.  
  174.           AUTOMATIC SHAPES:  The shape will appear on the screen in a
  175.           light color, indicating the size of the shape to be drawn.
  176.  
  177.      CIRCLE:   B2 toggles between moving the circle and changing
  178.           the diameter. Initially, the circle moves with the cursor.
  179.           
  180.                Click B2 to freeze the midpoint of the circle and
  181.                adjust the diameter.  Moving the mouse to the right
  182.                will increase the diameter; moving left decreases the
  183.                diameter. Click B2 again to move the adjusted circle
  184.                around the screen.
  185.  
  186.                Click B1 to draw the circle in the Selected Color. Move
  187.                the cursor to see the circle you have drawn.  The
  188.                circle tool is still selected and active.
  189.  
  190.           Double click B1 to draw a circle filled with the
  191.           Selected Color.  (Objects in the circle which are
  192.                outlined in the Selected Color will not